查询 Transfer 对象列表

返回之前创建过 transfer 对象的一个列表。列表是按创建时间进行排序,总是将最新的 transfer 对象显示在最前。如果不设置 created 参数,默认查询近一个月的数据;设置了 created 参数,会按照对应的时间段查询。

请求参数描述
app[id] expandable optional string转账使用的 app 对象的 idexpandable 可展开,查看如何获取App ID
limit optional int限制每页可以返回多少对象,范围为 1~100 项,默认是 10 项。
starting_after optional string在分页时使用的指针,决定了列表的第一项从何处开始。假设你的一次请求返回列表的最后一项的 idobj_end,你可以使用 starting_after = obj_end 去获取下一页。
ending_before optional string在分页时使用的指针,决定了列表的最末项在何处结束。假设你的一次请求返回列表的第一项的 idobj_start,你可以使用 ending_before = obj_start 去获取上一页。
created optional timestamp对象的创建时间,用 Unix 时间戳表示,具体参考下表 created 参数。
channel optional string付款使用的第三方支付渠道名称。目前支持 wx(微信 App)、wx_pub(微信 JSAPI)、wx_lite(微信小程序)、alipay(支付宝)、unionpay(银联电子代付)、allinpay(通联代付)、jdpay(京东代付)和balance(余额)。
status optional string付款状态。目前支持 4 种状态:pending: 处理中; paid: 付款成功; failed: 付款失败; scheduled: 待发送。
type optional string付款类型,转账到个人用户为 b2c,转账到企业用户为 b2b。
created 参数说明描述
created[gt] optional int大于 transfer 对象的创建时间,用 Unix 时间戳表示。
created[gte] optional int大于或等于 transfer 对象的创建时间,用 Unix 时间戳表示。
created[lt] optional int小于 transfer 对象的创建时间,用 Unix 时间戳表示。
created[lte] optional int小于或等于 transfer 对象的创建时间,用 Unix 时间戳表示。

返回

返回一个已存在的 transfer 对象的列表或者一个错误,详见 错误

定义

GET https://api.pingxx.com/v1/transfers?expand[]=app
\Pingpp\Transfer::all();
Transfer.all(Map options);
Pingpp::Transfer.all
pingpp.transfers.list();
pingpp.Transfer.all()
transfers.List(&TransferListParams)
list(Dictionary<String, Object> params)

请求示例

curl https://api.pingxx.com/v1/transfers/?limit=3&expand[]=app
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC:
\Pingpp\Pingpp::setApiKey('sk_test_ibbTe5jLGCi5rzfH4OqPW9KC');

\Pingpp\Transfer::all(array('limit' => 3));
Pingpp.apiKey = "sk_test_ibbTe5jLGCi5rzfH4OqPW9KC";

Map<String, Object> transferParams = new HashMap<String, Object>();
transferParams.put("limit", 3);

Transfer.all(transferParams);
require "pingpp"
Pingpp.api_key = "sk_test_ibbTe5jLGCi5rzfH4OqPW9KC"
Pingpp::Transfer.all(:limit => 3)
var pingpp = require('pingpp')('sk_test_ibbTe5jLGCi5rzfH4OqPW9KC');
pingpp.transfers.list({ limit: 3 }, function(err, transfers) {
// YOUR CODE
});
import pingpp
pingpp.api_key = 'sk_test_ibbTe5jLGCi5rzfH4OqPW9KC'
res = pingpp.Transfer.all(limit=3)
pingpp.Key := "sk_test_ibbTe5jLGCi5rzfH4OqPW9KC"
params := &pingpp.TransferListParams{}
params.Filters.AddFilter("limit", "", "3")
Dictionary<String, Object> params = new Dictionary<String, Object>();
params.Add("limit", 3);
try {
   TransferList trs = Transfer.list(params);
   Console.WriteLine(trs);
} catch (Exception e) {
   Console.WriteLine(e.Message.ToString());
}

返回示例

{
  "object": "list",
  "url": "/v1/transfers",
  "has_more": true,
  "data": [
      {
        "id": "tr_HqbzHCvLOaL4La1ezHfDWTqH",
        "object": "transfer",
        "type": "b2c",
        "created": 1432724825,
        "time_transferred": null,
        "livemode": true,
        "status": "pending",
        "app": "app_1Gqj58ynP0mHeX1q",
        "channel": "wx_pub",
        "order_no": "123456789",
        "amount": 100,
        "amount_settle": 100,
        "currency": "cny",
        "recipient": "Openid",
        "description": "Your Description",
        "transaction_no": "1000018301201505200184147302",
        "failure_msg":null,
        "extra": {
           "user_name": "User Name",
           "force_check": true
        }
     }
  ]
}